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PRODUCED BI-MONTHLY BY H.V.V2 


A NON PROFIT ORGANIZATION 


“ «* EDITOR'S COMMENTS ** 39/2 


FRONT COVER 
WE HAVE JASON OAKLEY'S ARTISTIC TALENTS TO THANK FOR THE NEW FRONT COVER. 


IN CASE YOU HAVEN'T WORKED IT OUT THE RODENT SIGNIFIES A VZ MOUSE. 


MELE = SELL & Teli PAGE 3 
SIXTH BIRTHDAY, LAST MEETING, WA VISITOR, MORE PUBLIC DOMAIN, WANTED DISK 


DRIVE SYSTEM AND SOURCE CODE ROUTINES. 


VZ MOUSE BY GARY BULLEY PAGES 4-9 

AT LONG LAST AFTER MANY REQUESTS THE MOUSE PROJECT IS A REALITY. MAKE 
SURE YOU READ EDITOR'S WARNING AND NOTE ON 2ND MOUSE PROJECT ON PAGE 8 BEFORE 
PROCEEDING WITH CONSTRUCTION. 


KSCAN PT IT BY LESLIE MILBURN PaGES 11-12 
LESLIE CONTINUES HIS ARTICLE ON ENHANCING VZ KEYBOARD INPUT WHICH IS ALSO 

CONTINUED IN NEXT ISSUE. IF LESLIE'S PLANS COME TO FRUITION THEN THE HUMBLE 

VZ WILL COME CLOSE TO THAT OF AN IBM TYPE COMPUTER. I FOR ONE WISH HIM LUCK. 


ASSEMBLY LANGUAGE PART IL PAGES 13-16 


BY BOS KITCH 
PaRT II oF Boe's ASSEMBLY TUTORIAL TAKES US FURTHER ALONG THE ROAD IN 


UNDERSTANDING ASSEMBLER PROGRAMMING. WELL WORTH THE READ. 


QUTCKWRITE INFORMATION PAGES 17-18 


BY LESLIE MILBURN 
LESLIE PROVIDES US WITH INFORMATION ON QUICKWRITE WORD PROCESSOR VERSIONS 


AND THEIR STRUCTURE. 


DAVE MITCHELL SOFTWARE FOR SALE PAGE 19 
PATCHS .35 — EXT DOS & MENU/FILE COPIER 


PETER HICKMAN SOFTWARE FOR SALE PAGE 19 
Vz MODEM & M/C DISASSEMLER 


USER GROUPS * NEWS ™* SUBSCRIPTIONS PaGE 22 


BELTEVE IT OR NOT: 


A WEEK AGO I TOOK MY CAR FOR A REGO CHECK AND AS A RESULT BOUGHT 5 NEW 
TYRES AS THE OLD ONES WOULD NOT HAVE LASTED MORE THAN SIX MONTHS. NEXT sToP 
WAS TO NRMA TO GET MY GREEN SLIP. THEY COULDN'T FIND NO RECORD OF MY PREVIOUS 
ONE SO ASKED TO SEE MY OLD REGO PAPERS. 


[IT OIDN'T TAKE LONG FOR THEM TO FIND OUT THAT MY REGO WAS STILL 6 MONTHS 
AWAY ANDO THAT I HAD MY SON’S REGO PAPERS. THE LESSON I LEARNED FROM THE MIXUP 
IS THAT IN FUTURE I MUST PUT ON MY READING GLASSES AND GET STUCK INTO SILICON 
TO IMPROVE MY MEMORY CHIPS. 


DISCLAIMER: EveRY EFFORT IS MADE TO INSURE THE ACCURACY OF 
INFORMATION CONTAINED WITHIN SE IT GENERAL, TECHNICAL, PROGRAMMING, ETC. NO 
RESPONSIBILITY CAN BE ACCEPTED BY HUNTER VALLEY VZ USERS’ GROUP OR AUTHOR AS A 
RESULT OF APPLYING SUCH INFORMATION IN PRACTICE. 


COPYRIGHT = THE HUNTER VALLEY VZ JOURNAL IS SUBJECT TO COPYRIGHT ano 
NO MATERIAL IN THE JOURNAL MAY BE REPRODUCED IN PART OR WHOLE WITHOUT THE 
CONSENT OF THE HUNTER VALLEY USERS' GROUP OR THE AUTHOR WHO RETAINS COPYRIGHT. 
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CLUB & JOURNAL. GTH BIRTHDAY : 


AS THE FRONT COVER SHOWS THE HUNTER VALLEY VZ JOURNAL IS SIX YEARS OLD AND 
IS THE LONGEST RUNNING VZ PUBLICATION TO DATE. IT HAS BEEN A VERY ENJOYABLE 5 
1/2 YEARS FOR ME AS EDITOR AND EVEN AFTER ALL THIS TIME I'M STILL LEARNING 
ABOUT THE VZ AND INTEND TO KEEP GOING FOR SOME TIME YET. 


My SINCERE THANKS TO OUR PAST AND PRESENT CONTRIBUTORS TO THE JOURNAL FOR 
THEIR SUPPORT VIA THEIR EXELLENT ARTICLES, ASSISTANCE TO MYSELF WHICH HAS MADE 
my JOB SO MUCH EASIER. IN NO PARTICULAR ORDER I THANK THE FOLLOWING AND MY 
APOLOGIES IF [ LEFT SOMEONE OUT. 


DAVE MITCHELL, GRIAN GREEVE, ROBERT QUINN, BOB KITCH, GARY BULLEY, DAVE 
BoYce, LESLIE MILBURN, JASON OAKLEY, LARRY TAYLOR, PETER HICKMAN, RUSSELL 
HARRISON AND NEVILLE HUGHES. THANK. YOU FELLAS. 


A SPECIAL THANKS GOES ALSO TO OUR LOCAL, INTRASTATE, INTERSTATE AND 
INTERNATIONAL MEMBERS FOR WITHOUT WHOSE CONTINUED SUPPORT THERE WOULD BE NO 
JOURNAL OR CLUB. 


LAST MEETING : 


QUR LAST MEETING WAS HELD AT ROSS WOOD'S PLACE AND MOST OF THE EVENING WAS 
SPENT WITH AN IBM COMPATIBLE COMPUTER WHICH THE MAJORITY OF OUR LOCAL MEMBERS 
HAVE. OQuR VZ GROUP WAS ORIGINALLY FORMED SO WE COULD LEARN MORE ABOUT VZ 
COMPUTERS. WE STILL ARE A VZ = CUMPUTER CLUS WITH THE SAME AIM AS SEFORE, 
EXCEPT THAT AS WE LEARN WE NOW USE AND EN-COMPASS OTHER COMPUTERS AS WELL. 


WA VISITOR: 


BRIAN GREEVE AND HIS FAMILY FROM WESTERN AUSTRALIA CALLED IN COUPLE MONTHS 
AGO TO SAY HELLO. UNFORTUNATELY TIME DID NOT PERMIT THEM TO STAY MORE THAN A 
COUPLE HOURS WHICH WENT ALL TO QUICKLY. IT IS ALWAYS A PLEASURE TO MEET 
FELLOW VZ USERS. AS MENTIONED BEFORE IF YOU ARE IN THE NEIGHBOURHOOD PLEASE 
DO CALL IN TO SAY HELLO AND STAY TO HAVE A CUPPA AT LEAST. 


MORE PUBL ITC DOMALIN : 

A COUPLE MORE VZ SOFTWARE AUTHORS HAVE DECLARED THEIR PROGRAMS PUBLIC 
DOMAIN. THE PROGRAMS IN QUESTION ARE TWO OF THE MOST SOPHISTICATED EVER 
WRITTEN FOR THE VZ COMPUTERS. THEY ARE: 

1) ROBERT QUINN DATABASE (TAPE/DISK VERSIONS) 
2) LES MILBURN QUICKWRITE WORD PROCESSOR SERIES (DETAILS PAGES 17-18) 


FOR MORE INFORMATION CONTACT EDITOR. 


WANTED DISK DRIVE SYSTEM: 


IF YOU HAVE A SYSTEM FOR SALE THEN PLEASE LET ME KNOW AS I[ HAVE HAD 
SEVERAL ENQUIRIES FROM MEMBERS WISHING TO PURCHASE A SYSTEM. EDITOR. 


SOURCE CODE ROUTINES: 


THE RESPONSE TO LAST ISSUE'S REQUEST WAS DISSAPOINTING WITH ONLY “WO 
MEMBERS PROMISING SOME ROUTINES. THE IDEA WAS AND IS FOR ALL VZ USERS TO 
SHARE AND LEARN FROM EACH OTHER'S ROUTINES. THE REQUEST STILL STANDS. IF vou 
CAN HELP OUT PLEASE CONTACT EDITOR. 


VZ 200/300 MOUSE BY GARY BULLEY 3S9/4 


SOME TIME AGO I STARTED ON A PROJECT TO INSTALL A MOUSE ON THE VZ. 
THIS LED TO A SERIES OF PROJECTS WHICH DELAYED THE END RESULT 
SOMEWHAT BUT OVER THE NEXT FEW EPISODES OF THE JOURNAL I WILL DESCRIBE 
ALL THE PROGRESS MADE SO FAR. IT WILL BE ENOUGH TO GET THE MOUSE UP 
AND RUNNING AND ENABLE YOU TO DEVELOP YOUR OWN PROGRAMS FOR USING IT. 


TWO MAJOR PROJECTS HAVE TO BE UNDERTAKEN. ONE IS THE 8 BIT INPUT 
PORT WHICH HAS ALREADY BEEN DESCRIBED IN A PREVIOUS ISSUE. THE OTHER 
IS MODIFICATIONS TO THE MOUSE. 


THE MOUSE I USED WAS PURCHASED FROM TANDY AND IS A SERIAL MOUSE 
CAT No. 25-104DC 1@A9. BECAUSE THE MOUSE HAS TO BE MODIFIED I THINK 
ANY TYPE OF CHEAP MOUSE ON TO-DAY'S MARKET WOULD: BE SUITABLE. THE 
MODIFIED CIRCUIT IS MADE UP ON A SMALL PIECE OF VERO BOARD AND HOUSED 
INSIDE THE MOUSE CASE. IT CONNECTS BY FLYING LEADS TO THE APPROPRIATE 
POINTS ON THE MOUSE HARDWARE. 


THE FOLLOWING IS A DESCRIPTION OF HOW THE MOUSE WORKS: 


INSIDE THE MOUSE THERE ARE TWO CIRCULAR DISKS. ONE DISK FOR THE 
HORIZONTAL TRAVEL AND THE OTHER FOR VERTICAL. AROUND THE 
CIRCUMFERENCE OF THESE DISKS ARE CUT EVENLY SPACED SLOTS. JHE OISK IS 
ARRANGED SO THAT AS IT ROTATES THE SLOTS WILL INTERRUPT A LIGHT BEAM 
THAT IS FOCUSSED ON A PAIR OF LIGHT SENSING TRANSISTORS. 


EACH DISK IS DRIVEN BY A SHAFT WHICH IS IN CONTACT WITH A RUBBER 
BALL. Now AS THE MOUSE IS MOVED THE BALL WILL. ROTATE WHICH IN TURN 
ROTATES THE DISK AND THE RESULT IS A SQUARE WAVE OUTPUT FROM THE 
TRANSISTORS THAT IS PROPORTIONAL TO MOUSE MOVEMENT. THIS SQUARE WAVE 
CAN NOW BE USED TO TRIGGER A LATCH WHICH WILL INDICATE MOUSE MOVEMENT 
AND DIRECTION. 


AS THE OISK IS ROTATED IN ONE DIRECTION THE BEAM WILL BE CUT 
WHICH WILL BLOCK THE TRANSISTORS FROM ANY LIGHT AND THEIR OUTPUT WILL 
GO TO A LOGIC ONE. FURTHER ROTATION WILL ALLOW LIGHT TO PASS THROUGH 
A SLOT AND EXPOSE THE TRANSISTOR TO THE BEAM AND NOW IT'S OUTPUT WILL 
DROP To aA LoGcrc ZERO. THIS IS HOW THE SQUARE WAVE IS PRODUCED AND 
WILL CONTINUE AS LONG AS THE DISK IS ROTATED... THE SAME WILL APPLY 
WHEN THE DISK IS ROTATED IN THE OPPOSITE DIRECTION, A SQUARE WAVE 
OUTPUT WILL STILL BE PRODUCED. 


NOW IF THE OUTPUT OF A LATCH IS SET TO A ZERO THIS SQUARE WAVE 
THAT IS PRODUCED BY THE MOUSE CAN TRIGGER THE LATCH AND SET IT'S 
OUTPUT TO A ONE, SO BY MONITORING THE OUTPUT OF THE LATCH WE CAN TELL 
WHEN THE DISK HAS. ROTATED. I.E. IF THE LATCH OUTPUT REMAINS AT ZERO 
THEN NO MOVEMENT HAS OCCURRED. 


THIS LEAVES THE DIRECTION OF MOVEMENT TO BE DETERMINED. [0 DO 
THIS A SECOND LATCH IS USED ALONG WITH THE SECOND TRANSISTOR BUT THIS 
TIME THE TRANSISTOR IS USED TO SET THE OUTPUT OF THE LATCH AT EITHER A 
ONE OR ZERO OEPENDING ON WHETHER THE TRANSISTOR IS EXPOSED TO THE 
LIGHT OR CUT OFF. 


THE TWO TRANSISTORS ARE POSITIONED SIDE BY SIDE EACH OTHER IN THE 
PATH OF THE BEAM. AS THE DISK IS ROTATED IN ONE DIRECTION A STAGE Is 
REACHED WHERE BOTH TRANSISTORS ARE EXPOSED TO THE BEAM. FURTHER 
ROTATION WILL CUT OFF ONE TRANSISTOR (CALL IT TRANSISTOR A) AND IT'S 
OUTPUT WILL RISE TO A ONE. AS A IS USED TO TRIGGER THE MOVEMENT LATCH 
THE OUTPUT OF THE LATCH WILL RISE TO A ONE AND THIS RISING OUTPUT CAN 
THEN BE USED TO TRIGGER THE SECOND (DIRECTION) LATCH. 
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BECAUSE THE SECOND TRANSISTOR (B) IS STILL EXPOSED TO THE BEAM, 
IT's ouTputT WILL BE ZERO AND SO THE OUTPUT OF THE DIRECTION LATCH IS 
SET AT ZERO. FURTHER ROTATION WILL EVENTUALLY CUT THE BEAM TO B BUT 
THE OUTPUT STATE OF THE LATCHES WILL NOT CHANGE AND WILL STAY LIKE 
THIS WHILE EVER THE DISK ROTATES IN THIS DIRECTION. WHEN THE OISK IS 
ROTATED IN THE OPPOSITE DIRECTION TRANSISTOR A WILL STILL TRIGGER THE 
MOVEMENT LATCH AND B THE DIRECTION LATCH, BUT THIS TIME TRANSISTOR B 
WILL BE CUT FROM THE BEAM BEFORE A SO IT'S OUTPUT WILL BE A ONE WHICH 
WILL SET THE DIRECTION LATCH TO A ONE WHEN IT IS TRIGGERED. 


IN THE CIRCUT DIAGRAM FOR THE MOUSE THE OUTPUT FROM THE FOUR 
LATCHES IS LOADED IN PARALLEL ALONG WITH THE TWO PUSH BUTTONS INTO THE 
741S5165 CHIP AND IS THEN CLOCKED OUT SERIALLY TO THE INPUT PORT OF THE 
V2. ONCE INSIDE THE VZ IT IS TREATED BY SOFT WARE AS AN 8 BIT WORD 
AND THE BITS CHECKED INDIVIDUALLY FOR MOUSE MOVEMENT AND DIRECTION AS 
WELL AS PUSH BUTTON OPERATION. 


CIRCUIT BOARD : 


STUDY THE CIRCUIT BOARD (VERO BOARD) CAREFULLY UNTIL YOU ARE SURE 
OF ALL THE CONNECTIONS. THERE ARE A NUMBER OF BRIDGES TO GO IN BEFORE 
THE IC'S ARE SOLDERED IN PLACE. BECAUSE SIZE AND SPACE ARE AT A 
PREMIUM THE BOARD IS A BIT CRAMPED. USE SMALL GAUGE LEADS AND A GOOD 
CLEAN SOLDERING IRON FOR THE BEST RESULTS. THE CONNECTION BETWEEN 
BRIDGE B AND PIN 3 OF THE 74LS165 IS A BIT TRICKY. 


PASS THE WIRE THROUGH THE HOLE NEAR PIN 3 THEN SEND IT OVER ON THE 
COPPER SIDE OF THE BOARD AND SOLDER IT TO PIN 3. YOU WILL HAVE TO 
WORK OUT THE TERMINATION POINTS FOR THE HORIZONTAL, VERTICAL AND ?USH 
BUTTONS ON THE MOUSE THAT YOU PURCHASE. IF YOU HAVE A CIRCUIT OIAGRAM 
IT WILL BE A BIG HELP OTHERWISE A GOOD MAGNIFYING GLASS, PENCIL AND 
PAPER WILL BE THE ONLY ALTERNATIVE. 


8 BIT INPUT PORT MODS: 
THERE IS ONE MODIFICATION TO BE MADE TO THE 8 BIT INPUT PORT. THE 


STROBE SIGNAL (PIN 12/74LS138) HAS TO BE CONNECTED TO PIN 11 oF DBI5. 
REFER TO ISSUE 3@, PAGES 9-11 FOR MORE DETAILS ON 8 BIT INPUT PORT. 


VZ MOUSE SOURCE CODE: 
@Q1 ;***VZ MOUSE*** 


G62 ; ORIGIN 6000H 

Q@3 : WRITTEN BY 

Q04 ;: GARY BULLEY 

Q@@5 : (AUTO START ON RESET) | 

046 DEFB @AAH : FIRST FOUR IDENTITY BYTES 
007 DEFB 55H FoR ROM IPL SEQUENCE. 

008 DEFB @E7H 

G09 DEFB 18H 

610 LD HL,STRT : LOAD INTERUPT VECTOR 

O11 LD (787EH) ,HL WITH MOUSE START ADDRESS. 
Q12 LD A,@C3H 

013 i) (787DH) A 

O14 JP 1A1SH > JUMP TO READY. 

915 ;MOUSE INPUT 

016 STRT LD HL, INPT - LOAD 8 BIT WORD FROM 

017 LD B, 98H MOUSE AND STORE AT 

018 OUT (1),A INPUT LOCATION. 


@i9 LOOP IN A, (1) 
026 RRA 
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G21 

822 
923 
O24 
825 
@26 
O27 
828 
029 
030 
Q31 

Q32 
0353 
054 
935 
@36 
037 
438 
@39 
040 
4 

942 
043 
O44 
G45 
046 
Q47 
948 
O49 
050 
51 

952 
@53 


954 


G55 
456 
Q57 
058 
@59 
060 
061 
062 
063 
064 
G65 
066 
@67 
068 
@69 
070 
071 
O72 
073 
074 
Q75 
0/6 
Q77 
878 
@79 
080 
081 
082 


RR OC 
DJNZ LOOP 
LD (HL) ,C 
BIT 5,C 
JR NZ,CRSR 
LD HL,FLAG 
BIT @, (HL) 
RET NZ 
POP HL 
POP DE 
POP BC 
PQP AF 
EXX 
POP DE 
LD HL,SPFN 
PUSH HL 
PUSH DE 
EXX 
PUSH AF 
PUSH. BC 
PUSH DE 
PUSH HL 
RET 
;MOVE VERTICAL 
CRSR INC HL 
BIT 1H,C 
JR Z,HORZ 
DEC (HL) 
RET NZ 
INC (HL) 
INC HL 
LD (HL), 3H 
BIT @H,C 
LD =A, (783CH) 
LD ~=—s-HL,. (7820H) 
LD CHL) A 
LD BC,@@2Q@H 
JR NZ,DOWN 
XOR A 
SBC HL,BC 
LD A,H 
CP 70H 
RET ™M | 
JR CHAR 
DOWN XOR A 
ADC HL,BC 
LD 8 A,H 
ce 72H 
RET P 
JR CHAR 
; HORIZONTAL 
HORZ BIT 3H,C 
JR = NZ,MOVE 
LD A,@1 
LD CHL) ,A 
INC HL 
LD CHL) ,A 
RET 
MOVE INC HL 
DEC (HL) 
RET NZ 
INC (HL) 


ws Se 


we 


-_ ‘we 


we hh we PH we VR we © 


wa 
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REG C=INPUT WORD. 

TEST BUTTON 2. 

JUMP IF NOT PUSHED. 
TEST FLAG FOR 

SPECIAL FUNCTION MODE. 
RETURN IF YES. 

STACK THE STACK 

WITH SPECIAL FUNCTION 
ADDRESS. 


RETURN. 


HL=VERTICAL COUNTER. 

TEST VERTICAL MOVEMENT. 
JUMP IF NONE. 

DECREMENT VERTICAL COUNT. 
RETURN IF NOT ZERO. 
INCREMENT VERTICAL COUNT. 


_ HL=HORIZONTAL COUNTER. 


LOAD COUNTER TO 3. 
TEST VERTICAL. DIRECTION. 


; REPLACE OLD CURSOR 


CHARACTER. 


BC=ONE SCREEN LINE. 
JUMP IF DIRECTION IS DOWN. 


; CALCULATE NEW 


CURSOR POSITION. 


RETURN IF ABOVE 
TOP OF SCREEN. 


: JUMP TO PRINT CHARACTER. 


CALCULATE NEW 
CURSOR POSITION. 


; RETURN IF BELOW 


BOTTOM OF SCREEN. 


; JUMP TO PRINT CHARACTER. 


TEST HORIZONTAL MOVEMENT. 
JUMP IF YES. 

LOAD VERTICAL 

COUNT TO 1. 

HL=HORIZONTAL COUNTER. 

LOAD COUNT TO 1. 

RETURN. 

HL=HORIZONTAL COUNT. 
DECREMENT HORIZONTAL COUNT. 
RETURN IF NOT ZERO. 
INCREMENT HORIZONTAL COUNT. 
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083 DEC HL ; HL=VERTICAL COUNTER. 
084 LD (HL) ,@3H : LOAD COUNTER TO 3. 

085 LD A, (783CH) ; REPLACE OLD CURSOR 

Q86 LD HL, (782@H) © CHARACTER. 

@8/ LD (HL) ,A 

888 LD A, 1FH : CALCULATE CURSOR 

@89 AND L POSITION. 

0398 BIT 2H,C s TEST HORIZONTAL POSITION. 
G91 JR NZ, RGHT ; JUMP IF RIGHT. 

@92 DEC A : CALCULATE NEW POSITION. 
935 RET ™M ; JUMP IF LEFT OF SCREEN. 
G94 CALL 3227H ; CALL ROM MOVE LEFT ROUTINE. 
Q@95 JR FINS ; JUMP TO FINISH. 

@96 RGHT XOR iFH ; CALCULATE NEW POSITION. 
Q97 RET Z ; JUMP IF RIGHT OF SCREEN. 
498 CALL 31B8H : CALL ROM MOVE RIGHT ROUTINE 
499 JR FINS ; JUMP TO FINISH. 

1@@ CHAR LD A, CHL) ; STORE NEW CURSOR 

101 LD (7/83CH) ,A CHARACTER AND 

1@2 LD (782@0H) ,HL POSITION. 

1463 FINS LD A,4QH :s. FLASH NEW CURSOR CHARACTER. 
104 XOR (HL) 

105 _D (HL) ,A 

186 LD A, 1@H : RESET CURSOR FLASH RATE. 
107 LD (7841H) ,A 

108 RET ; RETURN. 

189 FLAG NOP ; FLAG WORD. 

11@ INPT DEFB 86 | s INPUT WORD LOCATION. 

111 ; VERTICAL COUNT 

112 DEFB @1H ; VERTICAL COUNTER. 

113 ;HORIZONTAL COUNT 

114 DEFB @1H ; HORIZONTAL COUNTER. 

175 ;SPEC FUNCTION 

116 SPFN PUSH AF ; START OF SPECIAL 

117 PUSH BC FUNCTION ROUTINE. 

118 PUSH DE 

119 PUSH HL 

120 LD HL,FLAG 

121 SET @, CHL) 

122 LD A,9@H 

123 XOR (1LY+@BH) 

124 LD (TY+@BH) ,A 

125 INC HL 

126 KPSH BIT  5,.(HL) 

127 JR Z,KPSH 

128 DEC HL 

129 RES @, CHL) 

130 POP HL 

134 POP ODE 

HAZ POP BC 

133 POP AF 

134 RET 


PROGRAM. NOTES =: 


THE PROGRAM HAS BEEN WRITTEN TO RESIDE AT 6@QOH BUT BECAUSE THERE 
IS NO MEMORY AT THIS LOCATION IN A STANDARD VZ IT WILL REQUIRE A 
MODIFICATION TO BE DONE IF YOU WANT TO USE THIS LOCATION. THE PROGRAM 
COULD BE RELOCATED ANYWHERE IN MEMORY IF YOU SO DESIRED. THE REASON [ 
CHOSE THIS LOCATION IS BECAUSE VERY FEW PROGRAMS USE THIS SECTION OF 
MEMORY SO THE PROBLEMS OF IT BEING CORRUPTED OR CORRUPTING OTHER 
PROGRAMS IS VIRTUALLY NILL. 
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THE OTHER REASON IS THAT THE IPL SEQUENCE CHECKS FOR A PROGRAM AT 
6Q8@@H AND WILL AUTOMATICALLY RUN THE PROGRAM IF THE FIRST 4 IDENTITY 
BYTES ARE CORRECT. THIS WAY EVERY TIME THE RESET BUTTON IS PUSHED THE 
MOUSE PROGRAM WILL BE UP AND RUNNING AND WILL NOT HAVE TO BE RELOADED 


EACH TIME. 


THE PROGRAM AND DESCRIPTION IS REASONABLY STRAIGHT FORWARD BUT 
THERE ARE A FEW THINGS THAT MAY NEED EXPLAINING. IF YOU ARE GOING TO 
RE-ASSEMBLE IT FOR ANOTHER SECTION OF MEMORY THEN THE PROGRAM WILL 
START AT LINE 10. THE 8 8BIT WORD THAT IS INPUT FROM THE MOUSE 
CONTAINS ALL THE INFORMATION FOR CURSOR MOVEMENT AND PUSHBUTTON 
OPERATION. 


IT HAVE WRITTEN A SMALL PROGRAM THAT IL HAVE CALLED "SPECIAL 
FUNCTION MODE” AND USES BUTTON 2 TO CHANGE DISK DRIVES. IT IS AN 
EXAMPLE OF HOW THE SUTTONS CAN BE USED AND USES A PROGRAM CALLED 
"STACK THE STACK", IT WORKS LIKE THIS EVERY TIME A SOFT WARE 
INTERRUPT OCCURRS THE MOUSE ROUTINE IS RUN AND THE BUTTONS SCANNED. 


IF ®8UTTON 2 IS PUSHED THE STACK IS LOADED WITH THE ADDRESS OF THE 
SPECIAL FUNCTION PROGRAM WHICH WILL CAUSE THE PROGRAM TO RETURN BACK 
TO IT INSTEAD OF THE MAIN PROGRAM. ONCE THE SPECIAL FUNCTION PROGRAM 
IS FINISHED THE PROGRAM WILL RETURN TO ITS CORRECT ADDRESS. SEE BOR 
KITCH'S DESCRIPTION IN ISSUE 24 “VECTORS AND INTERRUPTS EXPLAINED’. 


THE REST OF THE PROGRAM LOOKS AFTER THE CURSOR MOVEMENT. IN ORDER 
TO SLOW DOWN MOUSE MOVEMENT TWO COUNTERS ARE USED. WHAT HAPPENS L535 
WHEN THE MOUSE IS MOTIONLESS BOTH COUNTERS ARE LOADED WITH A COUNT OF 
I WHEN MOVEMENT IS DETECTED IN ANY DIRECTION THAT DIRECTION COUNTER 
[IS STILL LOADED WITH A COUNT OF 1 AND THE OTHER DIRECTION COUNTER IS 
LOADED WITH A COUNT OF 3. BY DOING THIS IT LOCKS IN TO THE DIRECTION 
WITH THE LOWER COUNT AND SECOMES MORE STABLE IN MOVEMENT. 


THE WHOLE OF THE MOUSE PROGRAM IS MACHINE CODE BUT THERE ARE FOUR 
LOCATIONS THAT CAN BE USED BY BASIC WITH THE PEEK COMMAND. LINE 1@9 
IS THE FLAG LOCATION FOR THE SPECIAL FUNCTION ROUTINE. BIT @ IS THE 
ONLY BIT USED SO THERE IS PLENTY OF ROOM FOR EXPANSION. 


LINE 11@ IS THE LOCATION OF THE 8 BIT INPUT WORD FROM THE MOUSE. 
THIS IS PROBABLY THE MOST IMPORTANT LOCATION AS FAR AS PROGRAMMING 
GOES AS BITS @ TO 5 ARE THE MAIN INDICATORS OF WHAT THE MOUSE IS 
DOING. LINES 112 AND 114 ARE THE DIRECTION COUNTERS. 


EDITOR? S WARNING s 


FOR THE ABOVE PROJECT TO WORK CORRECTLY USE A MOUSE WHICH HAS A 
PHOTO INTERRUPTER OR LED/PHOTO TRANSISTOR ARRANGEMENT ON EACH SIDE OF 


BOTH SLOTTED DISKS. THERE ARE SOME MICE AROUND WHICH HAVE ONLY A 
SINGLE INTERRUPTER ON EACH SLOTTED DISK AND ARE NOT SUITABLE FOR THIS 
PROJECT. USUALLY WHEN YOU BUY A MOUSE A SOFTWARE PROGRAM COMES WITH 


[IT WHICH IS USED WITH THE PARTICULAR TYPE OF MOUSE PURCHASED. THIS 
DOES AWAY WITH. MOST INCOMPATIBILITY PROBLEMS. | 


<=_ND VZ MOUSE FPROJECT sz 


AFTER GARY BULLEY'S VZ MOUSE ARTICLE WAS EDITED I WAS NOTIFIED OF 
A SECOND VZ MOUSE PROVECT DONE BY ANOTHER VZ USER. IT DIFFERS FROM 
GARY'S IN THAT NO MODIFICATIONS TO THE MICE ARE NECESSARY. IT ALSO 
USES THE 8 BIT INPUT PORT, BUT WITH A MINOR MODIFICATION. THE PROVECT 
SHOULD APPEAR IN NEXT ISSUE SO CONSTRUCTORS CAN MAKE THEIR CHOICE. 
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KSCAN BY LESLIE MILBURAI —~F/1e 
FOR VZ2OO / SOO rFAaART — 2 


USING KSCAN WITH BASIC PROGRAMS 


TO EASILY USE KSCAN WITH BASIC PROGRAMS, FOUR FUNCTIONS HAVE BEEN 


PROVIDED. THESE ARE AS FOLLOWS:-— 


(1) 


(2) 


(3) 


SETDELAY (FLAG, NO) 


THIS FUNCTION ALLOWS A PROGRAM TO ALTER THE LENGTH OF THREE TIME 
DELAY LOOPS. 


FLAG CAN ONLY BE ONE OF THE FOLLOWING (NOTE THAT THIS IS QUOTED) :- 
G —- GENERAL DELAY. THIS OCCURS EVERY INTERRUPT. 


K - KEYSTROKE DELAY. THIS OCCURS EVERY TIME A NON-ZERO KEY CODE 
IS RETRIEVED FROM THE KEY TABLES. THIS DELAY IS IN ADDITION 
TO THE GENERAL DELAY. 


P —- PAUSE DELAY. THIS OCCURS WHEN A KEY IS PRESSED WHICH CANCELS 
THE PAUSE FUNCTION. 


NO IS THE TIME DELAY AMOUNT. 


SETADDR (FLAG, NO) 


THIS FUNCTION ALLOWS A PROGRAM TO CUSTOMISE KSCAN. 
FLAG CAN ONLY BE ONE OF THE FOLLOWING (NOTE THAT THIS IS QUOTED) :- 


I —- INTERRUPT ROUTINE. BECAUSE KSCAN TAKES OVER THE INTERRUPT 
EXIT, IT WAS NECESSARY TO PROVIDE AN ALTERNATIVE. THE MAJOR 
DIFFERENCE IS THAT THIS FUNCTION IS CALLED AFTER THE KEY SCAN 
AND DISPLAY UPDATE. NO IS THE ADORESS OF THE ROUTINE. NOTE 
THAT THE INTERRUPT ROUTINE MUST HAVE BEEN SET UP OR BLOADED 
PRIOR TO CALLING THIS FUNCTION. 


T - ALTERNATE TABLE. THIS OPTION ALLOWS AN APPLICATION TO MAKE 
KSCAN USE AN ALTERNATIVE SET OF KEY TABLES. I.E. AN 
APPLICATION MIGHT BLOAD ITS OWN TABLES FROM DISK. NO IS THE 
ADDRESS OF THE KEY TABLE FOR ROW @ AND IT IS EXPECTED THAT THE 
KEY TABLES ARE ONE AFTER THE OTHER IN MEMORY. 


YU - USER FUNCTION. THIS OPTION ALLOWS AN APPLICATION TO PROVIDE 
ITS OWN MACHINE CODE KEY TRAP ROUTINE. NO IS THE ADDRESS OF 
THE USER FUNCTION. 


RESETADDR (FLAG) 


THIS FUNCTION ALLOWS AN APPLICATION TO CANCEL AN OPTION SET BY 
SETADDR(). AS ABOVE, FLAG CAN ONLY BE ONE OF THE FOLLOWING (NOTE 
THAT THIS IS QUOTED) :- 


[ - INTERRUPT ROUTINE. THIS CANCELS AN APPLICATION PROVIDED 
INTERRUPT ROUTINE. 


U - THIS CANCELS AN APPLICATION PROVIDED USER FUNCTION. 


T - THIS CAUSES KSCAN TO REVERT BACK TO SCANNING THE DEFAULT KEY 
TABLES. 
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(4) X = SETKEY (ROW, COLUMN, KEYCODE, STATUS) 


THIS FUNCTION ALLOWS AN APPLICATION TO CHANGE A KEY CODE IN THE 
SET OF KEY TABLES CURRENTLY BEING USED 8Y KSCAN. THE PREVIOUS KEY 


CODE STORED IN THE VARIABLE. 
THE PARAMETERS TO THIS FUNCTION ARE AS FOLLOWS:- 


ROW ~ THIS IS THE ROW NUMBER OF THE KEY TO BE REDEFINED IN THE 
KEYBOARD MATRIX. THIS MUST BE IN THE RANGE @ - 7. 


COLUMN -—- THIS IS THE COLUMN OF THE KEY TO BE REDEFINED IN THE 
KEYBOARD MATRIX. THIS MUST BE IN THE RANGE @ - 5, 


KEYCODE - THIS IS THE VALUE TO BE STORED IN THE KEY TABLE. IT 
MUST BE IN THE RANGE @ - 255. 


STATUS - THIS INDICATES THE ALT/CTRL/SHIFT status. IT mMusT BE IN 


THE RANGE @ - 7, 

BIT @ INDICATES THE ALT KEY STATUS. 
BIT 1} INOICATES THE CTRL KEY STATUS. 
BrtT 2 INDICATES THE SHIFT KEY STATUS. 


Examples of the new BASIC commands 


SETDELAY ("K", 1@@) 
SETS THE KEYSTROKE DELAY TO APPROX. 1/10 OF A SECOND. 
SETADDR( "1", 30719) 


SETS UP AN INTERRUPT ROUTINE WHICH IS LOCATED AT ADDRESS 3@719 
DECIMAL . 


POKE 30719,201:POKE 3072@, 1 
SETADDR ("T" , PEEK (38719) +256"PEEK (30720) ) 


THIS SETS UP AN INTERRUPT ROUTINE WHICH IS LOCATED AT THE ADDRESS 
STORED IN LOCATIONS 380719 AND 30720. $IN THIS CASE @1CSH IS CALLED 
UPON EACH INTERRUPT. 


X = SETKEY(2,5,"Q", 4) 


THIS REDEFINES THE SHIFT-7 KEY COMBINATION TO DISPLAY A “Q". THE 
PREVIOUS KEY CODE IS STORED IN VARIABLE X. 


Using KSCAN with Machine Code Programs 


To USE KSCAN wTH M/C PROGRAMS A LITTLE MORE WORK IS REQUIRED ON 
THE PART OF THE PROGRAMMER. HOWEVER, AS USUAL WHEN WRITING M/C 
PROGRAMS THERE IS MORE FLEXIBILITY. 


AS KSCAN IS RELOCATABLE, DIRECT ADDRESSING MUST NOT BE USED TO 
CALL THE ROUTINES OR ACCESS ANY KSCAN "VARIABLES". 


THE ADDRESSES OF TWO IMPORTANT LOCATIONS HAVE BEEN STORED IN “HE 
COMMUNICATIONS REGION. THESE ARE AS FOLLOWS:- 


KSCAN FART—2 CONT INUED =~ F112 


KFUNs 317735-/75: THIS CONTAINS THE INSTRUCTION JP RFUN AND HELPS 
INDIRECT FUNCTION CALLS. 


STRT: 31276-77: THIS IS THE ADORESS OF KSCAN. ALL FUNCTION OFFSETS 
ARE RELATIVE TC THIS ADORESS. 


NOTE: THESE LOCATIONS CLASH WITH THE FIND ROUTINE. THIS SHOULD NOT BE 
A PROBLEM IF THE FIND ROUTINE IS LOADED FIRST. 


Accessing KSCAN "variables" & functions. 


AS MENTIONED ABGVE, DIRECT ADDRESSING CANNOT BE USED. TO OVERCOME 
THIS PROBLEM ALL VARIABLES ARE AT FIXED OFFSETS FROM THE START OF 
KSCAN WHICH IS STORED IN STRT. BELOW IS A LIST OF VARIABLES, THEIR 
OFFSETS AND A BRIEF DESCRIPTION: — 


VCTR: 2@ : ADORESS OF ORIGINAL RST 1Q@H VECTOR. 
KFLG: 22 ; STORES STATUS OF VARIOUS SYSTEM FUNCTIONS. 
UADD: 23 : FLAG INDICATING THAT AN APPLICATION HAS SET A USER FUNCTION 


ADDRESS. 
TADD: 24 : FLAG INOICATING THAT AN APPLICATION HAS SET AN INTERRUPT 
| ADDRESS. 
GODLY: 25 : GENERAL DELAY VALUE. 


KDLY: 27 : KEYSTROKE DELAY VALUE. 

PDLY: 29 : PAUSE DELAY VALUE. 

INT : 31 ; ADDRESS OF INTERRUPT FUNCTION. 

USR : 345 :; ADDRESS OF USER FUNCTION. 

KROW: 55 : STORES A SNAPSHOT OF KEYBOARD MATRIX. 
TBL : 43 : CONTAINS POINTERS TO KEY CODE TABLES. 


ALSO STORED AT FIXED LOCATIONS ARE THE OFFSETS OF THE MOST USEFUL 


FUNCTIONS. THIS ALLOWS FUNCTION CALLS TO BE MADE IN THE FOLLOWING 
WAY :>- 

EXX 

LD DE,FUNCTION OFFSET 

CALL KFUN. 


{[T f£S UP TO THE FUNCTION BEING CALLED TO EXCHANGE THE REGISTERS 
BACK AGAIN. THIS METHOD IS ADVANTAGEOUS AS REGISTER VALUES ARE 
PRESERVED THUS ALLOWING PARAMETER PASSING TO FUNCTIONS. THE ORDER OF 
ALL FUNCTION AND VARIABLE OFFSETS MUST NEVER SBE ALTERED. [WO AREAS 
HAVE BEEN SET ASIDE FOR FUTURE EXPANSION. 


scanning the keyboar 


UNFORTUNATELY THE VZ TECHNICAL MANUAL TAUGHT A LOT OF US A BAD 
HABITS BY =INSTRUCTING US TO CALL THE DEFAULT KEY SCAN ROUTINE IN ROM 
(ZEF4H) DIRECTLY RATHER THAN INFORMING US THAT A BETTER METHCD EXISTS. 


REGARDLESS OF WHETHER KSCAN IS INSTALLED OR NOT THE CORRECT WAY TO 


SCAN THE KEYBOARD IS TO CALL @@2BH. THIS SCANS THE KEYBOARD VIA HE 
0.C.B. AND ALLOWS US TO PATCH KSCAN INTO THE SYSTEM. 


CONTINUED NEXT ISSUE . . .« 


ASSErBLY LANGUAGE PART II oF /1IS 
BY BOB KITCH 


WITH THAT BIT OF BACKGROUND, YOU CAN NOW EXAMINE LISTING 3. £THIS 


IS A BASIC PROGRAM wRITTEN FOR THE "VISIBLE Z8@". THE BASIC PROGRAM 
SIMULATES WHAT AN ASSEMBLER PROGRAM COULD LOOK LIKE THAT DOES A SCREEN 
FILL, THE USE OF VARIABLE NAMES ARE ESPECIALLY CHOSEN TO CORRESPOND 


WITH THE "MYSTERIOUS" REGISTER NAMES ON THE 78@. 


BY WAY OF FURTHER BACKGROUND, THE ZILOG (THE MANUFACTURERS OF THE 
£8@) SPECIFICATION FOR THE LDIR INSTRUCTION IS AS FOLLOWS - 


A. THE HL REGISTER POINTS TO THE SOURCE OF THE LOAD. 

B. THE DE REGISTER POINTS TO THE DESTINATION OF THE LoaD. 

C. THE BC REGISTER CONTAINS THE COUNT OR NUMBER OF TIMES THE LOAD Is 
TO TAKE PLACE. 

D. THE A REGISTER IS THE TRANSFER POINT BETWEEN THE SOURCE (HL) Ta 
DESTINATION (DE} _oCcATIONS. 

E. AFTER EACH TRANSFER, THE HL AND DE REGISTERS ARE INCREMENTED AND 
THE BC (COUNTER ) REGISTER IS DECREMENTED. 

F. THE PROGRESSIVE LOADING IS REPEATED UNTIL THE BC REGISTER IS 
DECREMENTED TO ZERO —- IN WHICH CASE THE INSTRUCTION IS TERMINATED. 


CONDITIONS A. TO C. ARE THE INITIALIZATION FOR THE LODIR 
INSTRUCTION. THE ACTUAL EXECUTION OF THE INSTRUCTION INVOLVES 
CONDITIONS 93. TO F. THE WAY IN WHICH ZILOG EXPRESS ALL OF THIS IS A 
LITTLE CRYPTIC BUT FOR THOSE OF YOU INTERESTED IT IS AS FOLLOWS - 


(DE)<-<HL), DE<-DE+1, HL<-HL+1, BC<-BC-1, REPEAT until BC=9. 


f TRUST THAT #2 CAN FIGURE SOME CORRESPONDENCE BETWEEN THIS 
CONCISE DESCRIPTION AND MY "WORD PICTURE" PROVIDED ABOVE. 


IN LINES 200 To 460, THE BASIC PROGRAM WITH THE CORRESPONDING 
PSUEDO-ASSEMBLER IS GIVEN. [TRY TO FOLLOW THE RELATIONSHIP BETWEEN THE 
TWO LANGUAGES. READING AND UNDERSTANDING OTHER PROGRAMMERS’ CODE IS A 
VERY USEFUL FORM OF LEARNING. I[ MENTIONED THAT THE ASSEMBLER LDIR 
INSTRUCTION IS QUITE POWERFUL, IT TAKES 4 BASIC COMMANDS ~O EXECUTE 
IT! THIS IS UNUSUAL, AS NORMALLY ONE ASSEMBLER INSTRUCTION WILL 
TRANSLATE TO ONE BASIC COMMAND. A FULL DISCUSSION OF THE ASSEMBLER 
ROUTINE IS GIVEN IN THE NEXT SECTION, 


THE ALGORITHM USED IN THIS EXAMPLE IS SIMPLE TO UNDERSTAND USING 
THE CHARACTERISTICS OF THE LDIR INSTRUCTION. THERE ARE MANY OTHER 
ROUTINES THAT WOULD ACHIEVE THE SAME vos. IT IS IMPORTANT TO REALIZE 
THAT THERE IS NEVER MERELY ONE WAY TO ACHIEVE A PARTICULAR END. THE 
PROGRAMMER GENERALLY CALLS UPON HIS EXPERIENCE WITH FAMILIAR COMMANDS, 
AND THESE MAY BE THE QUICKEST AND SHORTEST WAY OF ACHIEVING THE 
OBJECT. BUT THERE TIS NEVER ONLY ONE CORRECT SOLUTION TO CODING A 
PARTICULAR PROBLEM. ANOTHER ALGORITHM THAT WILL ACHIEVE A SCREEN FILL 
IS AS FOLLOWS- 


LD HL ,/7@0@H 

LD BC, 8@0H 
LP LD (HL) ,17@D 

INC HL 

DEC BC 

LD A,C 

OR B 

JR NZ, LP 

RET 


20, WITH THIS BACKGROUND, LISTING 3 SHOULD BE READILY 
COMPREHENSIBLE. THE TIMING IS NONE TO STARTLING, BUT IT IS A DEMO 


PROGRAM! 
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4. THE SAME THING IN ASSEMBLER: 
THE ASSEMBLER COCE FOR THIS EXERCISE WOULD LOOK AS FOLLOWS - 
LD A, 17@D 


LD HL, 7@@6@H 
LD DE, 7@@1H 


LD BE, /FFH 
LD (HL), A 
LDIR 
RET 


HOW WAS THIS PROGRAM AND LIST OF INSTRUCTIONS PUT TOGETHER? A 
PROCESS CALLED HAND ASSEMBLY WAS USED. (HAND ASSEMBLY IS USED FOR 
SHORT PROGRAMS - LONGER ONES ARE WRITTEN USING THE EDASM PROGRAM) . 


TO CARRY OUT HAND ASSEMBLY, THE FOLLOWING PIECES OF INFORMATION 
ARE REQUIRED - 


“A NUMERIC LIST OF 28@ INSTRUCTIONS, 

~AN ALPHABETIC LIST OF Z8@ INSTRUCTIONS AND, 

“A TABLE TO CONVERT DECIMAL (@ - 255) NUMBERS TO HEXADECIMAL 
(QOH —- @OFFH) NUMBERS. 


SHOULD ANY USER REQUIRE SUITABLE COPIES OF THE Two Z8@ CopE LISTS, 
THEY CAN SEND ME $2-@@ AND I WILL FORWARD COPIES BY RETURN MAIL. IT 
iS AN INTERESTING EXERCISE TO WRITE A BASIC PROGRAM THAT WILL PROVIDE 
A TABULATION OF DEC-HEX CONVERSION THAT IS SUITABLE FOR HAND ASSEMBLY. 


LET S EXAMINE HOW THIS ALGORITHM WORKS. YOU MAY WISH TO REEEF TO 
LISTING 35 TO GAIN A COMPLETE UNDERSTANDING. THE BLOCK FILL IS REALLY 
BEST THOUGHT OF AS A “RIPPLE-FILL". THE SOURCE IS ALWAYS THE BYTE 
PRECEDING THE OE€STINATION AND AS THE HL AND DE REGISTERS ARE 
INCREMENTED, A DESTRUCTIVE OVERWRITE OF THE PREVIOUS INFORMATION IN 
THE SLOCK OCCURS. 


NOTE THAT THE VALUE, CONTAINED IN THE A REGISTER, MUST BE LOADED 
INTO THE FIRST MEMORY LOCATION OF THE FILL TO INITIALIZE THE PROCESS. 
THIS INITIALIZATION IS MOST OFTEN FORGOTTEN BY BEGINNERS. ANOTHER 
COMMON MISTAKE IS TO SET THE COUNT IN BC, ONE TOO HIGH BECAUSE THE 
FIRST BYTE IS INITIALIZED “OUTSIDE” OF THE LDIR INSTRUCTION. I TRUST 
THAT USERS CAN FOLLOW THE LOGIC OF THIS ALGORITHM — IF NOT, GO BACK TO 
LISTING 3 IN BASIC. 


THE NEXT PROBLEM IN HAND ASSEMBLY IS TO FIND THE CORRESPONDING 
DECIMAL VALUES TO POKE INTO MEMORY AS MACHINE LANGUAGE. By USING THE 
28@ INSTRUCTION LISTS, MENTIONED PREVIGUSLY, A HEX EQUIVALENT OF THE 
ASSEMBLER CAN BE DERIVED. THESE ARE CONVERTED TO DECIMAL VALUES USING 
A CONVERSION TABLE (OR A CALCULATOR) AND ENTERED INTO DATA STATEMENTS. 

IT IS POSSIBLE TO PUT HEX VALUES INTO DATA STATEMENTS AND USE A HEX 
LOADER ROUTINE TO POKE THE VALUES INTO THE DESIGNATED AREA OF MEMORY. 


THE ONLY REMAINING PROBLEM IS WHERE TO LOAD THE M/L? THIS HAS 
BEEN DISCUSSED IN A PREVIOUS ARTICLE ON FAST BASIC. FoR LISTING 4, [ 
HAVE CHOSEN TO SIMPLY POKE IT INTO THE FREE SPACE LIST. “THIS IS A 
"LAZY" WAY, BUT I WILL FIX IT UP IN THE NEXT LISTING)! THE USR VECTOR 
IS SET TO THE START OF THE M/L. 


SAVE THE PROGRAM TO DISK/TAPE BEFORE RUNNING THE BASIC PROGRAM. 
ASSEMBLER IS TOTALLY UNFORGIVING IF ANY ERRORS ARE MADE AND YOU RUN 
THE RISK OF HAVING TO RE-ENTER THE ENTIRE PROGRAM. (BE WARNED) | 
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LISTING 4 ACHIEVES THE HI-RES SCREEN FILL IN ABOUT @.1 SECS. THIS 
IS WHAT WE WERE LOOKING FOR AND IT IS ACHIEVED WITH 15 BYTES OF M/L. 
[T TRUST THAT THIS HAS GIVEN SOME NEW INSIGHT INTO ASSEMBLY LANGUAGE 
PROGRAMMING AND TAKEN SOME OF THE MYSTERY FROM IT. THIS ARTICLE ALSO 
PROVIDES A PAINLESS INTRODUCTION TO ASSEMBLY LANGUAGE PROGRAMMING. 


oe MULTIPLE HI & LO RES SCREENS: 


i HAVE PROVIDED A BONUS FOR THOSE WHO HAVE PERSEVERED THUS FAR! 
LISTING 5 IS THE LOGICAL CULMINATION OF THE EXERCISE WE SET ABOUT TO 
ACHIEVE AT THE START OF THIS ARTICLE. IT USES A SLIGHTLY MODIFIED 
FORM OF THE ROUTINE DESCRIBED ABOVE. IT PERMITS THE VALUE SELECTED To 
FILi THE SCREEN TO BE PASSED, FROM THE BASIC PROGRAM, TO THE USR() 
ROUTINE. THE TECHNIQUE USED HAS BEEN DESCRIBED IN MY FAST BASIC 
ARTICLE. THE INTEGER VALUE CONTAINED IN THE BRACKETS OF THE USR 
STATEMENT IS PLACED INTO THE COMMUNICATION AREA AT ADDRESS 7921/7H AND 
CAN BE PICKED UP 8Y THE M/L PROGRAM. 


THERE ARE THREE FURTHER FEATURES OF THIS PROGRAM THAT I HAVE NOT 
YET OISCUSSED AND ARE WORTHWHILE TO INCORPORATE INTO BASIC-M/L 
MODULES. 


1. WHEN ENTERING M/L FROM DATA STATEMENTS, THE VALUES MUST B3E EXACT. 
OTHERWISE, THE M/L ROUTINE IS WRONG AND A COMPUTER MALFUNCTION WILL 


OCCUR. (THE SAME THING HAPPENS IF THE USR POINTERS ARE NOT SET 
CORRECTLY) | AS A CHECK THAT THE DATA STATEMENTS HAVE SEEN ENTERED 
CORRECTLY FROM A PROGRAM LISTING, IT IS USEFUL TO SET UP A "CHECKSUM" 
FACILITY. THIS SIMPLY KEEPS A RUNNING TOTAL OF THE DATA VALUES AS 


THEY ARE LOADED. 


BEFORE EXECUTING THE PROGRAM, THE CHECKSUM IS COMPARED To A 
CORRECT VALUE AND EXECUTION PREVENTED IF THE TWO VALUES DO NOT AGREE. 
IN LISTING 5, THE VARIABLE CS% IS USED IN LINES 21@ To 24Q. IT IS 
COMPARED WITH THE CORRECT VALUE IN LINE 25@ AND IF NOT CORRECT PASSES 
TO AN ERROR HANDLING ROUTINE IN LINE 1@@@. IF THE ERROR MESSAGE IS 
SEEN, THEN THE DATA STATEMENTS IN LINES 410 TO 470 NEED TO BE CHECKED. 


it. HOW MANY PROGRAM LISTINGS HAVE YOU READ THAT SIMPLY LIS™ THE DATA 
VALUES TO BE POKED INTO MEMORY WITH NO EXPLANATION? ANY WONDER THAT 
BEGINNERS HAVE DIFFICULTIES IN UNDERSTANDING! THE METHOD OF SETTING 
OUT THE M/L IN "PSUEDO-ASSEMBLER" FORM IS TO BE STRONGLY RECOMMENDED. 


111. THE PROGRAM PLACES THE 16 BYTES OF M/L INTO A RESERVED AREA OF 
MEMORY CREATED BY LOWERING THE TOP-OF-MEMORY. IF AT ANY TIME, YOU 
FEEL AS IF THE M/L ROUTINE IS NOT FUNCTIONING PROPERLY, THEN IT IS A 
SIMPLE MATTER TO LOAD A DISASSEMBLER PROGRAM ANDO DECODE THE TOM AREA. 
THIS ENSURES THAT IT IS CORRECTLY LOADED, THAT YOUR DECIMAL VALJES 
CARRY OUT THE ACTION THAT YOU THINK THEY DO, AND THAT THE AREA IS NOT 
BEING OVERWRITTEN BY SOME OTHER PROCESSES. THIS IS A VERY POWERFUL 
FORM OF DEBUGGING WHEN DEVELOPING M/L ROUTINES. 


LISTING 3: 


AD "WOE WH BOE TRE Te Ie SHE NG HOE OE -IOE E NE DEE HE ARE SE SIE INE JE SNE He SNE SRE SRE BNE SNE SNE HE SHE IE SOE 20 INE SNE 8 SE IE HE 2G SRG OIG 286 SHE te UNE 288 HE SHE ate ate one 


Q20 *** VISIBLE Z-8@ - DEMO OF LDIR ane 
030 ‘*** BOB KITCH - 7/3/91 - ASSEMBLER TUTOR ae 
Jug '*** EXECUTION TIME: 7@ SECONDS “we 


A5O 3 HE ME ME He ME EM EE SAE ME eRe SME Mee ESE RE 6 NE Me AE Fk SHE BE Re NEE AMEE HE NG NE NE HE IN RE SE 6 aN SE SRE BE HG NE HE Ne ale ae ate ae 


260 © 
@7@ ‘DEMONSTRATION OF SCREEN FILL IN BASIC THAT EMULATES 
080 ‘THE LDIR INSTRUCTION OF THE Z80 
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990 VARIABLES USED RESEMBLE THOSE OF THE Z8@ REGISTER SET 
100 © 

14@ MODE (1) 2 ***HT-RES SCREEN. 

15@ COLOR ,@ :' **®*GREEN BACKGROUND. 

16@ SOUND 1@,) :' ***TTMING MARK. 

170 

18@ ***ASSEMBLER SIMULATION STARTS HERE. 

19@ ***TNITIALIZE ALL OF THE REGISTERS USED. 

200 AZ=17@ :'LD A, 170 VALUE. 

210 HL%Z=28672 :'LD HL,7@@@H SOURCE. 

220 DEZ=28673 ‘'LD DE,7@01H DESTINATION. 

250 BC%=2047 :'LD BC,@7FFH COUNT. 

280 — 

290 =***PUT FIRST VALUE INTO START OF VIDEO RAM. 

Sr POKE HLZ,AZ :'’LDCHL),A 

386 

390 ***CARRY OUT DESTRUCTIVE BLOCK MOVE. 

40@ :' LOIR 

41@ POKE DE%Z,PEEK (HL) — (DE) <- (CHL) 

470 HLZ=HL%Z+?) a HL <- HL+1 

430 DEZ=DER+1 DE <- DE+1 

44Q BC%Z=BC%- 1 eC BC <- BC-1 

456 IF BC%<>@ THEN GOTO 41@: ' TEST FOR END 

46Q : RET 

47Q 

490  ***FTNISH OFF. 

50@ sOUND 1@,1 :' ***TTMING MARK. 

510 FOR [=@ TO 20@@:NEXT I 

520 sTOP 

6@Q@ END 

LISTING 4: 

AH 1 A SG AE RE He HE He HE THE ME Te ME BE HE HE HE HE HE WE He He AE SE IG HE HE He SNe HE He HE BE HG SOE HE SRE SE SHE SE HE SE BE SE HE HE BE UE RE EE NE HE HE KE ae RE ae He HE 2 
902 * NEAR-LIGHT-SPEED GRAPHICS DEMO -- HI-RES VERSION 1.32 - 
0@3 '* BY BOB KITCH -— 22/5/86 - 
AD4 {QE WE FH RE Me AE SHE He HE RE HE Ge UE She HE HE HOE AE Ot EE Ee NOE HE SE SE HE SEE Ge ee UE Et Be HE SE HE Re HE he UE Be UE EE HE HE UE UR HE 50k HE KE HE EE EE EEE 
005 — 

008 *** EXECUTION TIME <@.5 SECS. 

Q@@9 ***| OAD MACHINE CODE INTO FSL ABOVE BASIC VLT. 

Q01@ FOR I=-28687 TO -28673 

020 READ A:POKE I,A 

030 NEXT I 

0359 

Q@40@ DATA 62,170 : LD A,17@ (#170D BLUE) 

041 DATA 33,0,112 -'LD HL,7@@@H (#286720 START VIDEO RAM) 
042 DATA 17,1,112 :'LD DE,7@@1H (#28673D NEXT) 

942 DATA 1,255,7 - LD BC,@7FFH (#2@47D SIZE OF VIDEO RAM) 
Q44 DATA 119 : _D (HL),A 

045 DATA 237,176 : LDIR (BLOCK LOAD COMMAND) 

G46 DATA 2701 » RET 

O47 — 

949 “***TNITIALIZE USR() TO ADDRESS 8FF1H OR #-28687D IN FSL. 
05@ POKE 50@862,241:POKE 30863, 143 

Q58 - 

Q@59  ***OUT UP BLUE SCREEN. 

Q@60 MODE 41} :COLOR,@ 

@7@ SOUND 18,1! 

@8BO K=USR(Q) 

490 SOUND 19,1 

098 | 

999 ***DELAY TO VIEW SCREEN. 

10@ FOR I=@ TO 2@@@:NEXT [ 

11@ END 


T QUICKWRITE 39/17 
ITLBURN 


TO MY SUPRISE IN THE LAST COUPLE OF WEEKS I HAVE RECEIVED A FEW 
ENQUIRIES ABOUT QUICKWRITE. BELOW IS THE ANSWERS TO MOST OF THE 
QUESTIONS WHICH I FEEL MAY INTEREST OTHER PEOPLE. 

WHAT DO THE FILENAMES MEAN? 


THE RELEASE NUMBERING I USED IS AS FOLLOWS:- 


QW A.B.C 
WHERE: - 
QW - THIS IS THE APPLICATION ID. 
A - THIS IS THE VERSION OF THE APPLICATION. 
B - THIS INDICATES THE PROGRAM STRUCTURE LEVEL. 
(I.E. IMPROVEMENTS MADE TO EXISTING FACILITIES). 
C - THIS INDICATES THE NUMBER OF BUG CORRECTIONS APPLIED. 


PROGRAMMERS SHOULD NOTE THAT FILENAMES SHOULD BE CHOSEN WITH CARE. 


WHAT HAS SEEN RELEASED? 


THERE WERE 3 MAJOR VERSIONS OF QUICKWRITE RELEASED, THESE WERE:- 


QW - A _OW MEMORY DISK BASED WORD PROCESSOR: 

QW4 - AN ENHANCED VERSION OF QW3 WITH IMPROVED DISK & PRINTING 
FACILITIES; AND LASTLY 

QWIIT - A GENERAL PURPOSE EDITOR WHICH MADE USE OF BANK SWITCHED 
MEMORY . 


THERE WERE 6 FREE UPGRADES OF QW3 AND 3 FREE UPGRADES OF QW4. 
ONLY | VERSION oF QWII WAS EVER RELEASED. THE LAST RELEASED VERSIONS 
OF THESE wERE:- 


QW3.3.3; QW4.2.2 & QWII.4.7. 


WHY DOES QUICKWRITE II TEXT FILES HAVE A START ADDRESS OF Q@QQQH & 
END ADORESS OF FFFFH? 


THE ANSWER IS THAT THE FILE FORMAT OF QWII FILES CHANGED EVEN 
THOUGH THE FILETYPE IS THE SAME. ALL QW TEXT FILES HAVE FILETYPE “F”. 


QW3 & QW4 BOTH USE THE DKLOAD DOS FUNCTION TO LOAD A DOCUMENT. 
THE START ADDRESS IN THE DIRECTORY IS ACTUALLY 10 BYTES LESS THAN THE 
START OF THE ACTUAL TEXT. I.E&. EACH FILE HAS A 10 BYTE HEADER. ONLY 4 
BYTES OF THIS HEADER WERE EVER USED. THESE ARE:- 


HEADER SIZE (BYTES) DESCRIPTION 
2. THE LENGTH OF THE DOCUMENT. 
oO 2 THE CURSOR POSITION (ONLY USED BY EARLIER VERSIONS) . 


(UICKWRITE [IIT HAS ITS OWN DISK ROUTINES WHICH TAKE BANK SWITCHED 
MEMORY INTO ACCOUNT. IT DOES NOT USE THE START AND END ADDRESS IN THE 
OIRECTORY. TO LOAD A FILE IT LOADS ALL SECTORS BY FOLLOWING THE 
TRACK/SECTOR POINTERS. THE START ADDRESS OF @ & END ADDRESS OF FF-=FH 
ARE STORED IN THE DIRECTORY PURELY TO PREVENT QW3 & QW4& FROM TRYING TO 
(OAD THE FILE. THE FIRST SECTOR OF EACH QWII FILE IS USED TO STORE 
INFORMATION ABOUT THE FILE. THE CONTENTS OF THIS SECTOR ARE AS 
FOLLOWS :- 
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OFFSET SIZE (BYTES) DESCRIPTION 


a 2 THE TOTAL LENGTH OF THE FILE. 

Zz Z THE NO. OF BYTES IN THE LAST BANK USED. 
4 1 THE DEFAULT FILE FORMAT (1=LEFT JUST.) 
5 THE LEFT MARGIN WIDTH. 

5 Z BOTH SYTES ZERO. THIS INDICATES THAT THE 

FILE IS A QWIT FILE. 

8 | PAGE NUMBERING FLAG. (1=YES). 

Q 1 MAX. NO. OF PRINTER COLUMNS. 

:@ Z LINE LENGTH OF OUTPUT. 

1? Zz SIZE OF MARGIN AT TOP OF PAGE. 

iq Z NO. OF LINES PER PAGE. 

16 Z SIZE OF MARGIN AT BOTTOM OF PAGE. 

18 Z START PAGE NUMBER. 
2@ 2 INTERNAL BUFFER POINTER. 
22 2 INTERNAL BUFFER POINTER. 
24 1 WIDTH OF A TAB MARKER. 
25 TINDENT/TAB SELECTION FLAG. 


THE REMAINDER OF THE SECTOR IS CURRENTLY UNUSED. 


CAN QUICKWRITE BE MODIFIED TO WORK WITH MORE THAN 3 BANKS OF MEMORY? 


IN THEORY QWII COULD WORK WITH ANY NUMBER OF BANKS. HOWEVER, WHEN 
WRITING THE SYSTEM I MADE A MISTAKE BY HARD CODING THE MAXIMUM NUMBER 
OF SANKS IN THE CODE. IT IS NOT JUST A CASE OF CHANGING THE NUMBER AND 
REASSEMBLING. ALL FUNCTIONS WHICH USE THE CLIPBOARD WOULD HAVE TO SE 
MODIFIED (¢I.€. Cut, Copy, Paste, RuBpoutT, INSERT). AT THIS STAGE £ 
CANNOT SEE MYSELF DOING THIS. ALSO NOT MANY PEOPLE HAVE 64K RAMS LET 
ALONE MORE MEMORY. 


WILL THERE BE ANY MORE RELEASES OF QUICKWRITE? 


NO, NOT IN THE FORSEEABLE FUTURE. HOWEVER [| HOPE TO DO A SERIES 
OF ARTICLES WHICH WILL USE QW CODE AS THEIR BASIS. THE IDEA IS TO 
MAKE THE CODE APPLICATION INDEPENDANT. THE FIRST OF THESE ARTICLES 
WAS KSCAN WHICH WAS IN THE LAST JOURNAL. 


WHERE CAN [I GET A COPY OF QUICKWRITE? 


ALL VERSIONS OF QW CAN NOW BE FREELY COPIED AMONG YOURSELVES. THE 
DISKS WERE PROTECTED USING DISK GUARD. IF YOU CANNOT GET HOLD OF AN 
UNPROTECTED COPY GET IN CONTACT WITH:- 


J.P. LEON 33 TIGHES TERRACE TIGHES HILL 2297 (@49) 692 399 


CAN QUICKWRITE TEXT FILES BE USED BY A DISK BASED E&F WorRD PRO? 


A CONVERSION PROGRAM WOULD HAVE TO BE WRITTEN. WITH THE 
INFORMATION GIVEN ABOVE THE FILE CAN BE EASILY READ. ALL THAT IS 
REQUIRED [5S TO CONVERT ANY SPECIAL CHARACTERS. THE SPECIAL CHARACTERS 
ARE AS FOLLOWS:- 


NEw PAGE MARKER = 222 
TAB/ INDENT MARKER = 254 
CARRIAGE RETURN MARKER = 252 
FORMAT CODES = 24)-244 
USER DEFINED CHARS = 225-235 


x K XK DAVE MITCHELL SOFTWARE x xk x =PF/1IO 


EF & FWP PATCH 3S. Ss PATCH 3.3 WRITTEN BY Dave MITCHELL WILL CONVERT 
YOUR E & F TAPE WORD PROCESSOR FoR FULL DISK USE WHILE RETAINING ALL ORIGINAL 
FUNCTIONS. IT ALSO HAS SHIFT LOCK AND PRINTER CONTROL CODES WHICH CAN BE IMBEDDED 
IN TEXT AND SAVED TO TAPE OR DISK. 


BSTWP. Fs THIS UTILITY PROVIDED WITH PATCH 3.3 WILL CONVERT BASIC PROGRAMS 
AND ED/ASS. SOURCE CODE FILES INTO WORD PROCESSOR FILES. 


PRICE = AUS/NZ AUS20.00 - UPDATE - AUS-$10.00 - NZ-AUS11.20. 


EXTENDED DOS V1.2 THESE COMMANDS ARE AT YOUR DISPOSAL: MERGE, 
DIRA, DIRA, OIRB, LDIRB, OLD, OLD., DEC, HEX, MENU, CODE, LTAB, MOVE AND LPDATE, 
STATUSA AND LSTATUSA. STATUSA AND LSTATUSA ALSO WORKS WITH VERSION 1.@ DOS 


PRICE = $15.00 - POSTAGE INCLUDED 


MENUSFILE COPTER®: THIS UTILITY WILL READ YOUR DISK DIRECTORY AND 
PRESENT YOU WITH SEVERAL OPTIONS. USING THE CURSOR YOU CAN RUN/BRUN ANY PROGRAM 
OR SELECT FILE COPY, REN, ERASE, ORIVE 1 OR 2, Etc. Besrpes COPYING TEXT AND 
BINARY FILES ALL OTHER FILES CAN BE COPIED AS WELL EXEPT FOR DATA FILES. 


FP RECE = Au$i5.00 - POSTAGE INCLUDED 
FOR PURCHASE OR INFORMATION CONTACT: 


DAVE MITCHELL 24 ELPHINSTONE STREET 
NORTH ROCKHAMPTON GUEENSLAND 479061 
AUSTRALIA —- PHONE: (@79) 27 S519 


* Kk * PETER HICKMAN SOFTWARE * *« * 


VZ DISASSEMBLERS WAT, ANOTHER DISASSEMBLER? BUT, YOU HAVE ALREADY 
GOT ONE? THIS ONE IS DIFFERENT! THIS PROGRAM IS ENTIRELY WRITTEN IN MACHINE 
CODE . IT ACTUALLY RUNS ABOUT 4@ TIMES FASTER THAN D.S.E.’S DISASSEMBLER (OR ANY 
ONE ELSE'S }. IT WILL DISASSEMBLE ANY PROGRAM THAT YOU CAN BLOAD INTO Memory. IT 
WORKS WITH ANY VZ CONFIGURATION. IT OISASSEMBLES EVEN THE 88 EXTRA 728@ OPCODES 
THAT ZILOG DOESN'T ADMIT TO. 


PRICE = A$25.@0 — PRICE INCLUDES HARDCOPY MANUAL. 
TAPE AND DISK VERIONS AVAILABLE. 


VZ MODEM SOFWARE s DID YOU WANT TO TALK TO OTHER COMPUTERS VIA A 
mooem? DID YOu BUY THE DSE TERMINAL EPROM, ONLY TO DISCOVER THAT IT ONLY WORKS 
WITH TAPE. IT ONLY ALLOWS YOU TO PRINT FILES, NOT SAVE THEM OR SEND THEM! 


YOUR PROBLEMS ARE SOLVED! THE HICKMAN BROTHERS, PETER AND ANDREW, HAVE A BRAND 
NEW PROJECT WHICH WILL ALLOW YOU TO SEND, RECEIVE & SAVE FILES VIA A MODEM. IT 
WORKS WITH DISK! 


SALE PRICEs $275.00 - INCLUDED ARE INSTRUCTIONS FOR THE HARDWARE 
MODIFICATIONS. A SMALL MODIFICATION IS NEEDED TO YOUR DISK CONTROLLER. YOUR USER 
GROUP MAY HELP YOU MODIFY YOUR COMPUTER TO USE THIS EXCITING NEW SOFTWARE! 


THE MANUAL [S SUPPLIED ON DISK FOR PRINTING OUT WITH YOUR DISK VERSION OF & & 
F W/PROCESSOR. IF YOU DO NOT OWN AN E & F W/PROCESSOR THEN PLEASE ENCLOSE ANOTHER 
$5.00 (‘TOTAL $3@.Q@) FOR PHOTOCOPYING AND POSTAGE OF THE MANUAL. 


FOR PURCHASE OR INFORMATION CONTACT: 
FETTER HICKMAN FO BOX @&@ WERRINGTON 2747 
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x xX CONTRIBUTIONS TO THE JOURNAL X X 


IF YOU ARE THINKING OF CONTRIBUTING TO THE JOURNAL THE PREFERED FORMAT IS 
BASIC LISTINGS, WORD PROCESSOR OR SOURCE CODE FILES ON TAPE OR DISK. FILES FROM 
THE FOLLOWING WORD PROCESSORS CAN BE ACCEPTED :— 


E & F TAPE OR DISK PATCH 3.1-3.3, WORDPRO CARTRIDGE, WORDPRO PATCH, MOST SOURCE 
CODE FILES AND ALL QUICKWRITE WORD PROCESSOR FILES. 
x *«* CLUB MEETINGS — ALL WELCOME X x 


FIRST FRIDAY OF MONTH 


*x * FUTURE MEETINGS — NEW VENUE »* x 


AS MENTIONED BEFORE WE NO LONGER MEET AT JUNC, BUT AT VARIOUS MEMBERS HOMES. 
MEETINGS WILL BE ONCE A MONTH AS BEFORE WITH THE DATES BEING FIRST FRIDAY OF THE 
MONTH . 


BECAUSE OF SOME LOCAL MEMBERS HAVING TO WORK SHIFTWORK MEETING DATES WILL BE 
ADJUSTED TO ACCOMODATE THEM. WHETHER YOU ARE A LOCAL MEMBER, INTRA OR INTERSTATE 
VISITOR PLEASE CHECK WITH JOE LEON FIRST BEFORE COMING OUT. 


JOE LEON 33 TIGHES Tce TIGHES HILL 2297 (049) 692 399 


x CLUB COMMITTEE & SUBSCRIPTIONS xX 


PRESIDENT - ROSS WOODS — SECRETARY/EDITOR - JOE LEON 
COMMITTEE MEMBERS — COLIN BRIDGE — PETER JONES 


SUBSCRIPTION TO - Aust. - 3 ISSUES $11.00 — 6 ISSUES 4321.0 
H.V.VZ. JOURNAL - N. Z. - 3 ISSUES $13.08 — 6 ISSUES $26.00 


FOR MORE INFORMATION CONTACT: 
Joe. LEON. 33. TiGHES Tce. TIGHES HILL. 2297 (@49) 692 399 AUSTRALIA 


MOTE =: PRICES INCLUDE FOST &® PACKING 


x K VS USER GROUPS = PUBLICATIONS Xx x 


VZ DOWN UNDER - VZ MAGAZINE - 6 ISSUES - $18.02 PER ANUM 
HARRY HUGGINS 12 THOMAS SrReeT MITCHAM VICTORIA 3152 


WAVZ - WESTERN AUSTRALIA VZ USER GROUP 
GRAEME BYWATER PO BOX 388 MORLEY WA 662 


BRISBANE VZ USERS WORKSHOP - C/O 63 TINGALPA St. WYNUM WEST 4178 
SOFTWARE FOR SALE - DISK MENU 


SAPPHIRE PRODUCTIONS - VZ DISK MAGAZINE - PUBLIC DOMAIN 
NOTE = VZ DISK MAGAZINE HAS CEASED PRODUCTION 


NOTE= WHEN WRITING TO ANY ABOVE OR H.V.VZ. USERS’ GROUP FOR INFORMATION 
PLEASE ENCLOSE A S.S.A.E. OR NZ 2 INT. REPLY COUPONS. 


